home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / bbs / cl14s24a.zip / REPORTS.DOC < prev   
Text File  |  1992-12-07  |  5KB  |  93 lines
  1. There are a few requirements to making some of the new reports I added to
  2. CALLS.EXE work.
  3.  
  4. *---------------------------------------------------------------------------
  5. For Event timing to work properly, you will need to send the following
  6. line to your CALLER log file (you can use CL-PRINT.COM that I wrote to do
  7. this):
  8.  
  9.        Scheduled Event ended at MM-DD-YY HH:MM:SS
  10.  
  11. This will cause CALLS to stop timing the event, rather than to continue the
  12. timing until a caller finally logs on.
  13.  
  14.  
  15. *---------------------------------------------------------------------------
  16. For the 'Average Event Program Times' report to contain anything to
  17. report on, you will need to send lines such as:
  18.  
  19.        Event: program name started at MM-DD-YY HH:MM:SS
  20.  
  21. where 'program name' is the name of any program or function you perform in
  22. your event. The keys here are the EVENT: at the front of the line which
  23. causes CALLS to recognize the line, the word STARTED which causes CALLS to
  24. first end the timing of any previous event and begin timing a new event
  25. which has a name of whatever text is between the 'EVENT: ' and ' STARTED'
  26. keywords, and finally the HH:MM portion of the line is picked up as the
  27. Time the previous event ended and the new event started. If any of these
  28. are not present, then CALLS will not function properly when generating this
  29. report
  30. .
  31. *---------------------------------------------------------------------------
  32. For the 'Languages Selected'  report to function, CALLS need to know
  33. which language was selected at logon. There is no provision in PCBoard to
  34. obtain this info but we can add it easy enough by placing Language Number
  35. in     Modem connect string
  36.         ie. Modem (1): CONNECT 2400
  37.     or Caller Number string
  38.         ie. Caller Number (1): 12345
  39.     or Security Level string
  40.         ie. Caller Security (1): 50
  41.  
  42.     This is accomplished by using MKTXT145 to modify the record for the
  43.     'Modem: @OPTEXT@' (rec no 590), 'Caller Number: @OPTEXT@' (rec no 591)
  44.     or 'Caller Security: @OPTEXT@' (rec no 592) and adding the text (n) to
  45.     the current text as shown above (where n is the language number, ie.
  46.     for your first language you add (1), for your second language PCBTEXT
  47.     file you add (2), etc...)
  48.  
  49. You must also setup PCBoard to include whichever entry you use in the CALLER
  50. log by using PCBSETUP and selecting the writing of the proper entry. If you
  51. use the Modem connect string, then local logons will not get counted which
  52. you may or may not desire. My preference would be the Caller Security since
  53. we need it anyways for other reports.
  54.  
  55. *---------------------------------------------------------------------------
  56. For the 'Number of Calls by Security Level' or 'Hours Used by Security Level'
  57. reports to work, you MUST have the Caller Security entry written to the log
  58. by PCBoard.
  59. *---------------------------------------------------------------------------
  60. For the 'Last Called In' report to work, you must write entries in the form:
  61.  
  62.     Last On: MM-DD-YY (HH:MM)
  63.     or
  64.     Last On: MM-DD-YY (HH:MM) for nn Minute(s)
  65.     or
  66.     Last On: MM-DD-YY (HH:MM) for nn Minute(s) - #nnnn
  67.  
  68. to the CALLER log. CALLS recogizes the LAST ON: at the beginning of the line
  69. and then uses only the MM-DD-YY portion of the line so the rest is just filler.
  70. (I like to see the time, how long and how many calls have they made so I don't
  71. have to go view their USER file data to find out.
  72.  
  73. *---------------------------------------------------------------------------
  74. For the CALLER ID to work you will need to write that data to the CALLER log.
  75.  
  76. *---------------------------------------------------------------------------
  77. One special consideration is the timing of the Doors and recognizing what door
  78. the user is in. Normally this is no problem as PCBoard writes entries to the
  79. log when the User opens the door, and returns to the board. CALLS only scans
  80. for particular data on a few doors that is designed to generate a report for.
  81. It only scans for a specific door's data when it sees the Opened Door (name)
  82. entry, rather than to compare every line for the data (which would slow down
  83. the program). The only problem that shows up, is if you go from one Door to
  84. another Door without returning to PCBoard. You can, however, fix this problem
  85. by simply writing an entry to the log such as:
  86.  
  87.     Opened Door (VERIFY) at HH:MM Via InstaReg
  88.  
  89. This would cause CALLS to stop timing the InstaReg door and start timing
  90. PCBVerify. Also to start scanning the entries for PCBVerify specific data
  91. rather than to continue scanning for InstaReg specific data.
  92. *---------------------------------------------------------------------------
  93.